home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 49 / Amiga Format CD49 (2000-01-17)(Future Publishing)(GB)(Track 1 of 3)[!][issue 2000-02].iso / -serious- / graphics / gnuplot / gnuplot-3.7.1src / gnuplot-3.7.1 / docs / old / readme.pic < prev    next >
Text File  |  1999-11-29  |  3KB  |  123 lines
  1.  
  2. HOW TO USE apsulateßlßl have tested driver under gnuplot3.2, and I am currently using it
  3. with the reengineered troff, groff, which is distributed by Free
  4. Software Foundation, but it should work for AT&T's DWB as well. As
  5. gpic can produce TeX output, it could possibly be an alternative to
  6. the LaTeX driver for TeX-users having the tpic macros (see the gpic
  7. man page - I don't know much about TeX so please don't ask me about
  8. this).
  9.  
  10. A simple graph can be formatted using
  11.  
  12. groff -p -mpic -Tps file.pic > file.ps.
  13.  
  14. The output from pic can be pipe-lined into eqn, so it is possible to put
  15. complex functions in a graph with the set label and set {x/y}label commands.
  16. For instance,
  17.  
  18. set ylab '@space 0 int from 0 to x alpha ( t ) roman d t@'
  19.  
  20. Will lable the y-axis with a nice integral if formatted with the
  21. command:
  22.  
  23. gpic filename.pic | geqn -d@@ -Tps | groff -m[macro-package] -Tps > filename.ps
  24.  
  25. Figures made this way can be scaled to fit into a document. The pic
  26. language is easy to understand, so the graphs can be edited by hand if
  27. need be. All coordinates in the pic-file produced by gnuplot are given
  28. as x+gnuplotx and y+gnuploty. By default x and y are given the value 0
  29. If this line is removed with an editor in a number of files one can
  30. put several graphs i one figure like this (default size is 5.0x3.0 inches)
  31.  
  32. .PS 8.0
  33. x=0;y=3
  34. copy "figa.pic"
  35. x=5;y=3
  36. copy "figb.pic"
  37. x=0;y=0
  38. copy "figc.pic"
  39. x=5;y=0
  40. copy "figd.pic"
  41. .PE
  42.  
  43. This will produce an 8 inches wide figure with four graphs in two rows
  44. on top of each other
  45.  
  46. One can also achieve the same thing by the command
  47.  
  48. set term pic x y
  49.  
  50. For example, using
  51.  
  52. .PS 6.0
  53. copy "trig.pic"
  54. .PE
  55.  
  56. the following session generated a two by two figure with
  57. four graphs:
  58.  
  59.  
  60.     G N U P L O T
  61.     unix version 3.2 
  62.     patchlevel 2, Mar 24 92
  63.     last modified Sat Mar 24 21:08:47 PST 1992
  64.  
  65. Copyright(C) 1986, 1987, 1990, 1991, 1992  Thomas Williams, Colin Kelley
  66.  
  67.     Send bugs and comments to bug-gnuplot@ames.arc.nasa.gov
  68.  
  69. Terminal type set to 'x11'
  70. gnuplot> set out 'trig.pic'
  71. gnuplot> set ter pic 0 5
  72. Terminal type set to 'pic'
  73. Options are 'Pic's origin is at (0.000000,5.000000)'
  74. gnuplot> plot sin(x)
  75. gnuplot> set ter pic 5 5
  76. Terminal type set to 'pic'
  77. Options are 'Pic's origin is at (5.000000,5.000000)'
  78. gnuplot> plot cos(x)
  79. gnuplot> set ter pic 0 0
  80. set ter pic 0 0
  81. Terminal type set to 'pic'
  82. Options are 'Pic's origin is at (0.000000,0.000000)'
  83. gnuplot> plot tan(x)
  84. gnuplot> set ter pic 5 0
  85. Terminal type set to 'pic'
  86. Options are 'Pic's origin is at (5.000000,0.000000)'
  87. gnuplot> plot cos(x)/sin(x)
  88. plot cos(x)/sin(x)
  89. gnuplot> quit
  90.  
  91.  
  92.  
  93. Scaling can be done using set size.
  94.  
  95.  
  96. I prefer this way of including graphs to using encapsulated in troff
  97. documents, because of the possiblity to preprocess with eqn, and
  98. because pic is much easier to understand than postscript  - at least for me.
  99.  
  100.  
  101. WHAT HAS TO BE DONE TO IMPROVE THIS DRIVER
  102.  
  103. 1.) Nice markers
  104.  
  105. 2.) Dot-dashed line styles
  106.  
  107. 3.) Possibly make line thickness an option when set term pic
  108.  
  109. 4.) Making it possible to select fonts for both pic and eqn from
  110.     gnuplot's command line.
  111.  
  112.  
  113. I am happy to share this piece of software with anyone, in the hope
  114. that it will be useful for at least someone. But taking into account
  115. that it is the very first version of the driver, I would be happy if I
  116. could get into contact with people able to help me improve it.
  117.  
  118. Mind you: Anything thats free comes with no guarantee!
  119.  
  120. Good Luck
  121.  
  122. Sigfrid Lundberg (siglun@volterra.teorekol.lu.se)
  123.